package com.allen.study.config;

import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import org.springdoc.core.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * 文档配置
 *
 * @author AllenSun
 * @since 2025-03-15 13:57
 */
@Configuration
public class SpringDocConfig {

// Swagger地址：http://localhost:8081/swagger-ui/index.html

    @Bean
    public OpenAPI customOpenAPI() {
        // 定义一个安全方案，这里使用的是 Bearer Token 认证方式
        final String securitySchemeName = "bearerAuth";

        // 创建一个 OpenAPI 实例
        return new OpenAPI()
                // 设置 API 信息，如标题、描述和版本
                .info(new Info().title("allen学习").description("接口文档").version("1.0.0"))
                // 添加全局的安全需求，即所有接口都需要进行认证
                .addSecurityItem(new SecurityRequirement().addList(securitySchemeName))
                .components(new Components()
                        // 定义安全方案，这里使用 Bearer Token 认证
                        .addSecuritySchemes(securitySchemeName, new SecurityScheme()
                                .name(securitySchemeName)
                                .type(SecurityScheme.Type.HTTP)
                                .scheme("bearer")
                                .bearerFormat("JWT")));
    }

    /**
     * 配置 API分组
     *
     * @return API分组Bean
     */
    @Bean
    public GroupedOpenApi groupedOpenApi() {
        return GroupedOpenApi.builder()
                .group("allen学习信息")
                .pathsToMatch("/**")
                .build();
    }
}